home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtPopdown.z / XtPopdown
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttPPPPooooppppddddoooowwwwnnnn((((3333XXXXtttt))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))      XXXXttttPPPPooooppppddddoooowwwwnnnn((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtPopdown, XtCallbackPopdown - unmap a pop-up
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           void XtPopdown(_p_o_p_u_p__s_h_e_l_l)
  13.                 Widget _p_o_p_u_p__s_h_e_l_l;
  14.  
  15.           void XtCallbackPopdown(_w, _c_l_i_e_n_t__d_a_t_a, _c_a_l_l__d_a_t_a)
  16.                 Widget _w;
  17.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  18.                 XtPointer _c_a_l_l__d_a_t_a;
  19.  
  20.           void MenuPopdown(_s_h_e_l_l__n_a_m_e)
  21.                 String _s_h_e_l_l__n_a_m_e;
  22.  
  23.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  24.           _c_a_l_l__d_a_t_a Specifies the callback data, which is not used by
  25.                     this procedure.
  26.  
  27.           _c_l_i_e_n_t__d_a_t_a
  28.                     Specifies a pointer to the _X_t_P_o_p_d_o_w_n_I_D structure.
  29.  
  30.           _p_o_p_u_p__s_h_e_l_l
  31.                     Specifies the widget shell to pop down.
  32.  
  33.           _s_h_e_l_l__n_a_m_e
  34.                     Specifies the name of the widget shell to pop
  35.                     down.
  36.  
  37.           _w         Specifies the widget.
  38.  
  39.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.           The _X_t_P_o_p_d_o_w_n function performs the following:
  41.  
  42.           +o    Calls _X_t_C_h_e_c_k_S_u_b_c_l_a_s_s to ensure popup_shell is a
  43.                subclass of _S_h_e_l_l.
  44.  
  45.           +o    Checks that popup_shell is currently popped_up;
  46.                otherwise, it generates an error.
  47.  
  48.           +o    Unmaps popup_shell's window.
  49.  
  50.           +o    If popup_shell's grab_kind is either _X_t_G_r_a_b_N_o_n_e_x_c_l_u_s_i_v_e
  51.                or _X_t_G_r_a_b_E_x_c_l_u_s_i_v_e, it calls _X_t_R_e_m_o_v_e_G_r_a_b.
  52.  
  53.           +o    Sets pop-up shell's popped_up field to _F_a_l_s_e.
  54.  
  55.           +o    Calls the callback procedures on the shell's
  56.                popdown_callback list.
  57.  
  58.           The _X_t_C_a_l_l_b_a_c_k_P_o_p_d_o_w_n function casts the client data
  59.           parameter to an _X_t_P_o_p_d_o_w_n_I_D pointer:
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttPPPPooooppppddddoooowwwwnnnn((((3333XXXXtttt))))     XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))      XXXXttttPPPPooooppppddddoooowwwwnnnn((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           typedef struct {
  75.                Widget shell_widget;
  76.                Widget enable_widget;
  77.           } XtPopdownIDRec, *XtPopdownID;
  78.      The shell_widget is the pop-up shell to pop down, and the
  79.      enable_widget is the widget that was used to pop it up.
  80.  
  81.           _X_t_C_a_l_l_b_a_c_k_P_o_p_d_o_w_n calls _X_t_P_o_p_d_o_w_n with the specified
  82.           shell_widget and then calls _X_t_S_e_t_S_e_n_s_i_t_i_v_e to resensitize
  83.           the enable_widget.
  84.  
  85.           If a shell name is not given, _M_e_n_u_P_o_p_d_o_w_n calls _X_t_P_o_p_d_o_w_n
  86.           with the widget for which the translation is specified.  If
  87.           a shell_name is specified in the translation table,
  88.           _M_e_n_u_P_o_p_d_o_w_n tries to find the shell by looking up the widget
  89.           tree starting at the parent of the widget in which it is
  90.           invoked.  If it finds a shell with the specified name in the
  91.           pop-up children of that parent, it pops down the shell;
  92.           otherwise, it moves up the parent chain as needed.  If
  93.           _M_e_n_u_P_o_p_d_o_w_n gets to the application top-level shell widget
  94.           and cannot find a matching shell, it generates an error.
  95.  
  96.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  97.           XtCreatePopupShell(3Xt), XtPopup(3Xt)
  98.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  99.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.